DSTU2

This page is part of the FHIR Specification (v1.0.2: DSTU 2). The current version which supercedes this version is 5.0.0. For a full list of available versions, see the Directory of published versions

Conformance-sdc-form-manager

This is the narrative for the resource. See also the XML or JSON format.


SDC Form Manager

(Requirements Definition)

Published: 2014-07-06 (draft)

Published by: U.S. Office of the National Coordinator (ONC)

This profile defines the expected capabilities of the SDC Form Manager role when conforming to the S&I Framework's Structured Data Capture FHIR implementation guide. This role is responsible for maintaining a repository of form definitions and also of performing pre-population of form data.

General

FHIR Version: 1.0.2
Supported formats: xml, json

REST behavior

The primary focus of the repository is the definition of Questionnaires. However, ValueSets must also be supported to allow definition of coded data elements. Some data elements will choose to maintain value sets as 'contained' resources, meaning the value set exists only in the context of the data element and cannot be referenced or maintained without also updating the data element. However, systems should support value set re-use across data elements. (Version-specific referencing can be used to avoid value sets from changing independent of the referencing Questionnaire.)

Security:

Implementations must meet the general security requirements documented in the SDC implementation guide.

Resource summary

Resource Search Read Read Version Instance History Resource History Create Update Delete
Questionnaire (Profile) SHALL SHALL SHALL SHALL SHALL SHALL MAY
ValueSet (Profile) SHALL SHALL SHALL SHALL SHALL SHALL MAY

Operations: populate MAY



Questionnaire

Interactions

Name Conformance Description
  search-type SHALL

Allows a user to search for existing forms

  read SHALL

Allows retrieval of a specific known form

  vread SHALL

Allows retrieval of a specific version of a form

  history-instance SHALL

Allows review of changes to a form over time

  create SHALL

Allows defining a new form. Repositories requiring curation of submitted forms may require all new data elements to have a status of 'draft'.

  update SHALL

Allows an existing form to be updated. Servers may choose to prohibit certain types of edits, instead requiring the creation of a new questionnaire (and potentially the retiring of the existing questionnaire). Servers may also limit who can change particular forms.

  validate SHOULD

SHOULD. Allows a client to verify whether a particular new form or revision of an existing form would be accepted based on validation and other business rules. Useful for some workflows

  delete MAY

Allows removal of an existing form. Servers may choose to not support deletions and instead require that the form's status be changed to 'retired'. Other systems support deletions but limit them to forms meeting certain requirements. E.g. only forms with a status of draft or only forms that have been retired for at least two years, etc.

Search

Supported Includes: Questionnaire.group.question.options

Parameter Conformance Type Definition & Chaining
code SHALL token
date SHALL date
identifier SHALL token
publisher SHALL string
status SHALL token
title SHALL string
version SHALL string
deReference SHALL token


ValueSet

Interactions

Name Conformance Description
  search-type SHALL

Allows discovery of existing value sets for use in authoring questionnaires

  read SHALL

Allows retrieval of a specific value set referenced within a questionnaire

  vread SHALL

Allows retrieval of a historical version of a value set as referenced within a questionnaire

  history-instance SHALL

Allows review of changes to a value set over time

  create SHALL

Allows definition of a new value set used by one or more questionnaires

  update SHALL

Allows existing value sets referenced by one or more questionnaires to be maintained

  validate SHOULD

Allows verification that a value set is valid prior to submission - useful for some workflows.

  delete MAY

Not all servers will support deletion of value sets. Status change to 'retired' will be more typical, though deletion of draft value sets may keep repositories cleaner.

Search

Supported Includes: ValueSet.compose.import

Parameter Conformance Type Definition & Chaining
code SHALL token
date SHALL date
description SHALL string
identifier SHALL token
name SHALL string
publisher SHALL string
reference SHALL string
status SHALL token
system SHALL string
version SHALL string

 

 

Usage note: every effort has been made to ensure that the examples are correct and useful, but they are not a normative part of the specification.